home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / win3x / gif / gifclp / gifclip.doc < prev    next >
Text File  |  1993-05-22  |  13KB  |  329 lines
  1.  
  2.  
  3.                           G I F C L I P 
  4.  
  5.                            Version 1.5
  6.                           May 20 , 1993
  7.      
  8.      A Cropping/Clipping Program for Your GIF(tm) Pictures
  9.          Copyright 1990,1993 Synergrafix Consulting.
  10.                       All rights reserved. 
  11.  
  12.      GIFCLIP is produced by:
  13.  
  14.            Steve Enns                 Synergrafix Consulting
  15.         44 Macdermid Cres.              44 Macdermid Cres.
  16.           Saskatoon, Sk.                 Saskatoon, Sk. 
  17.           Canada S7J 2R2                 Canada S7J 2R2 
  18.  
  19.      This document has been stolen from the original GIFWARP!
  20.      document - if you have GIFWARP!, all the "humor" in here    
  21.      is ginna' seem familiar...
  22.  
  23.      Our motto:
  24.      
  25.      "We endeavour to pursue faithfully the highest principles in
  26.      sophisticated program design and development - until we're
  27.      offered more money or more exciting jobs."
  28.  
  29.      Top Ten Phrases heard around this lab:
  30.  
  31.                "What does `File Allocation Table Bad' mean?"
  32.                "Where was that bottle?"
  33.                "Sure it's weird, but will it sell?"
  34.                "Are these deductions right?"
  35.                "Where's that Stones tape?"
  36.                "Yah, C is okay, but can you do it in FORTRAN?"
  37.                "Where was that bottle?"
  38.                "I thought YOU fed the sled dogs!"
  39.                "Error handling?  What's that?"
  40.                "Where was that bottle?"
  41.  
  42.      Okay, here's the boring stuff, but don't worry, it's better
  43.      than chewing tinfoil:
  44.  
  45. ACKNOWLEDGEMENTS
  46.  
  47.      Kudos, thanks, and good karma to John Bridges for the
  48.      enlightening information and code contained in his VGAKIT
  49.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  50.      their respective companies. 
  51.  
  52. DISCLAIMER
  53.  
  54.      The GIFCLIP program is provided without warranty of any
  55.      kind.  The user of the GIFCLIP assumes complete
  56.      responsibility for any and all incidental or consequential
  57.      damages which may occur during normal or abnormal use of the
  58.      GIFCLIP program.  Use the GIFCLIP program at your own risk.
  59.  
  60. LICENSE 
  61.  
  62.      The entire GIFCLIP package, including the GIFCLIP program,
  63.      documentation, and sample files are Copyright 1990,1993
  64.      Synergrafix Consulting.  All rights reserved.  The      
  65.      unregistered shareware version of the GIFCLIP may be freely
  66.      distributed to others by any means, as long the following
  67.      (three) conditions are met:
  68.  
  69.           1) GIFCLIP is distributed in a "package" containing    
  70.           the following three files:
  71.                               GIFCLIP.EXE
  72.                               GIFCLIP.DOC
  73.                               GC-READ.ME
  74.           
  75.           2) GIFCLIP is not distributed as part of any other     
  76.           product, except with specific written permission from
  77.           the author, Steve Enns.
  78.  
  79.           3) NO fee of any kind is charged for the GIFCLIP
  80.           package or for the service of providing the package,
  81.           except Computer Bulletin Board Systems, which may
  82.           distribute the GIFCLIP package even though they may
  83.           charge a membership or service fee.
  84.  
  85.      You can use the "shareware" version for as long as you want,
  86.      even until you're well into your nineties, but you are of
  87.      course encouraged to send us lots of money, too. (I'm
  88.      struggling to pay for my violin lessons, and Dan needs a new
  89.      fishing rod.)  On the other hand, a "registered" version of
  90.      GIFCLIP is available from the authors for $8.00 U.S.  The
  91.      registered version provides support for 512K and 1024K
  92.      SuperVGA cards from most manufacturers (see REQUIREMENTS
  93.      below).  The registered version is licensed to the          
  94.      purchaser exclusively, and may not be distributed to others. 
  95.      To order the SuperVGA version of GIFCLIP, send $8.00 U.S.   
  96.      to the "Steve Enns" guy mentioned above.  You will receive a
  97.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA  
  98.      version of GIFCLIP.  If you send $23.00 or more, you will   
  99.      also receive the licensed SuperVGA versions of:
  100.  
  101.           GIFWARP!  Warp, bend or stretch your GIF(tm) pictures
  102.                     for bizarre and interesting effects.
  103.  
  104.           GIFSIZE   Resize your GIFs.  Resize the entire image or
  105.                     any part.
  106.  
  107.           GIFEXE    Make your GIF(tm) into an executable program
  108.                     with special effects.  Just run the program
  109.                     to display the picture.  Great for demos or
  110.                     displays or title screens for your programs. 
  111.                     Supports SuperVGA.
  112.  
  113.      Look for the unlicensed shareware versions of GIFCLIP,
  114.      GIFSIZE and GIFEXE on your favourite bulletin board system.
  115.  
  116.  
  117. REQUIREMENTS
  118.  
  119.           GIFCLIP requires the following:
  120.  
  121.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  122.                -    About 280K of free RAM
  123.                -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested)
  124.                -    A mouse that at least claims to be
  125.                          compatible with something
  126.                -    A VGA or SuperVGA card
  127.  
  128.           and optionally:
  129.  
  130.                -    SuperVGA - The registered SuperVGA version of
  131.                     GIFCLIP supports modes like 640x480, 800x600 and
  132.             1024x768 with 256 colours on 512K and 1024K
  133.             SuperVGA cards from ATI, Ahead, Cirrus, Chips and
  134.                     Technologies, Everex, OAK, Paradise, Trident,
  135.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  136.             (S3 based cards with (bug-free!) VESA bioses are
  137.             now supported.) See the LICENSE section above for
  138.             ordering information.
  139.  
  140. INSTALLATION
  141.  
  142.      Copy the GIFCLIP program (and this helpful document of
  143.      course!) to any directory that you want - perhaps with      
  144.      your favourite GIF(tm) viewer somewhere in the DOS          
  145.      path.
  146.  
  147. USAGE
  148.  
  149.      Syntax for GIFCLIP is as follows:
  150.  
  151.           GIFCLIP [?] infilename[.GIF] [outfilename[.GIF]]
  152.                     [/text=some~text] [/giftag=giffile[.GIF]]
  153.                     [/autoscale]
  154.  
  155.      or
  156.  
  157.           GIFCLIP [?] infilename[.GIF] [outfilename[.GIF]]
  158.                     [/mode={0,1,2,3,4}] [/text=some~text]
  159.                     [/giftag=giffile[.GIF]]
  160.                     [/autoscale]
  161.  
  162.      for the registered version.  ( The /mode=n parameters are as
  163.      follows:       /mode=0        Ordinary 320x200 mode
  164.                     /mode=1        Low resolution SVGA
  165.                                         640x400 or 640x350
  166.                                         depending on your card.
  167.                     /mode=2        Medium resolution 640x480
  168.                     /mode=3        High resolution 800x600 
  169.                     /mode=4        Higher resolution 1024x768
  170.                                    on some 1024K cards. Try a VESA
  171.                    driver!)
  172.  
  173.      The /autoscale option will try to fit the GIF onto the
  174.      specified screen mode when the mode is much large than the
  175.      GIF.                                                   
  176.  
  177.      The /text option allows the placement of text on the GIF.
  178.  
  179.      The /giftag option allows placement of another GIF onto the
  180.      GIF.
  181.  
  182.      For example, try:
  183.  
  184.           C> GIFCLIP               to see the title screen
  185.  
  186.           C> GIFCLIP ?             to see the help/brag screen
  187.  
  188.           C> GIFCLIP house         to view/clip the file
  189.                                    HOUSE.GIF writing the clipped
  190.                                    picture (if any) to the 
  191.                                    default name GIFCLIP.GIF
  192.  
  193.           C> GIFCLIP house house2  view/clip the file HOUSE.GIF,
  194.                                    writing output to HOUSE2.GIF
  195.  
  196.           C> GIFCLIP house /text=Copyright~1991
  197.                                    view/clip the file HOUSE.GIF,
  198.                                    adding the text "Copyright
  199.                                    1991" when using the "text"
  200.                                    command.  (See below.)
  201.  
  202.           C> GIFCLIP house /giftag=myname.gif
  203.                                    view/clip the file HOUSE.GIF, 
  204.                                    adding the picture MYNAME.GIF
  205.                                    when using the "gif" command. 
  206.                                    (See below.)
  207.                
  208.      With the registered version:
  209.  
  210.           C> GIFCLIP car /mode=2   View/clip CAR.GIF using medium
  211.                                    resolution SuperVGA
  212.                               
  213. TUTORIAL
  214.  
  215.      Try out the following with your favourite GIF(tm) picture:
  216.  
  217.                C> GIFCLIP picturename
  218.  
  219.      GIFCLIP will load the picture and display it one your
  220.      screen.  The mouse cursor will appear in the centre of the
  221.      picture along with the coordinates of the current position. 
  222.      Choose the area of the picture that you want to save by
  223.      pressing and holding down the left mouse button while moving
  224.      the mouse.  The "clipping box" will move as you move the
  225.      mouse.  Release the left button when the "clipping box" is
  226.      the appropriate size.  To choose a different box, just press
  227.      and hold down the mouse at a different location in the
  228.      picture.  When you have chosen the area of the picture that
  229.      you want to save, press the <ENTER> key.  If you want to
  230.      exit GIFCLIP without saving the clipped picture, press the
  231.      <ESC> key. 
  232.  
  233.      Now try the following:
  234.  
  235.                C> GIFCLIP picturename /text=John~Doe,~1991
  236.  
  237.      GIFCLIP will operate as before, except that now you may also
  238.      place the text "John Doe, 1991" anywhere on your picture. 
  239.      Note that the tilde "~" is used for a space.  You can move
  240.      the mouse around and choose clipping areas as before,  but
  241.      now  when you press the right mouse button, the text
  242.      "John Doe, 1991" will appear, and can be moved around with  
  243.      the mouse.  Press the right mouse button again to place the
  244.      text on the picture.
  245.  
  246.      Finally, you can also try:
  247.  
  248.                C> GIFCLIP picturename /giftag=myname
  249.  
  250.      Now, press the "G" key.  The picture MYNAME.GIF will be
  251.      placed on top of the picture with the upper corner where the
  252.      mouse is pointing.  This option can be used to put logos,
  253.      signatures or any other picture on top of the current
  254.      picture.  (Note that the colours of the original picture
  255.      will be used for the imported picture.)
  256.  
  257.      Both of the GIFCLIP options /TEXT and /GIFCLIP may be used
  258.      together.
  259.      
  260.  
  261. ERRORS
  262.  
  263.      - The following self explanatory error messages may be
  264.      produced by GIFCLIP  The errors involving the GIF(tm) files
  265.      will generally be due to disk errors or faulty image files. 
  266.      Other errors refer to lack of enough free RAM space, or lack
  267.      of required hardware (VGA and Mouse).
  268.  
  269.           Can't initialize VGA graphics!
  270.           Mouse driver not installed.
  271.           Can't allocate mouse memory!
  272.           Unexpected EOF reading GIF!
  273.           Premature end of GIF!
  274.           Not GIF file!
  275.           Invalid GIF format
  276.           Error writing GIF!
  277.           Buffer allocation failure!
  278.           
  279. NOTES
  280.  
  281.      - GIFCLIP reads both GIF87A standard (the original) and     
  282.      new GIF89A pictures, although most of the extensions in the
  283.      new GIF89A standard like (silly) text windows are ignored. 
  284.      The last image in multi-image GIFs will be the one displayed
  285.      for clipping in GIFCLIP.
  286.  
  287.      - Although only the registered copy of GIFCLIP provides     
  288.      full SuperVGA resolution, all GIF pictures can be decoded   
  289.      and displayed on all versions of GIFCLIP.  If the image is  
  290.      too large for the available resolution, the image will be   
  291.      centred on the screen.  You will see the middle 320x200     
  292.      pixels of the image when the entire image is larger than    
  293.      320x200, for example.  The registered version of GIFCLIP    
  294.      will display images at resolutions up to 1024x768 according
  295.      to the size of the picture, or the specified mode.
  296.  
  297. HISTORY
  298.  
  299.      - Version 1.0 Completed June.1 1991
  300.  
  301.      - Version 1.2 Completed Sep.15 1991
  302.           Some additional cards are now supported.  1024x768x256
  303.           modes are now supported on some 1024K cards.
  304.  
  305.      - Version 1.3 Completed Sep.20 1991
  306.           /autoscale is now an option
  307.  
  308.      - Version 1.4 BIG OL' BUG that disabled SuperVGA in
  309.           registered versions is now fixed.
  310.      
  311.      - Version 1.5 Completed May.20 1993
  312.       Support for additional graphics hardware, including
  313.       much better VESA support for S3 and other Windows
  314.       accelerator cards which support VESA.
  315.     
  316.  
  317. PROPOSED FUTURE ENHANCHMENTS
  318.  
  319.      - Support for other graphics hardware.  Hopefully, we will
  320.      be able to support new hardware and graphics modes as they
  321.      are introduced.
  322.  
  323.      - Faster GIF(tm) decoding and encoding
  324.  
  325.      - You tell me!
  326.  
  327.  
  328.  
  329.